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Fig. 4A 

// 

// Http Request Servlet 

// 

public class RequestServlet extends HttpServlet { 



void service(HttpServletRequest request, HttpServletResponse response) throws 

ServletException, lOException { 

// get an device format adapter that recognizes and handle this request 

// format from a Http Device Format Manager 

// the request can come from a browser or a mobile device or 

// any other source that conforms to the Http protocol 

400 HttpAdapter adapter = HttpDeviceFormatManager.getAdapter(request,response); 

// ask the adapter to convert the process the request 
// the adapter convert the request to a RequestObject recognized by the 
// web controller and invoke the processRequest() method on the web 
// controller 

402 adapter.processRequestO; 

} 



} 
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Fig. 4B(i) 

// DeviceFormatAdapter 

// - defines the basic interface that defines a device format adater 

// 

interface DeviceFormatAdapter { 

// returns a device format id 
getDevicePormatldO; 
// returns the device type 
getDeviceTypeO; 

// returns a adapter specific session context 
getSessionContextO; 

I! 

II HttpAdapter 

// - defines a Http specific device format adapter 

// 

interface HttpAdapter extends DeviceFormatAdapter { 
// return a the HttpServletRequest 
getRequestO; 

// returns the input parameters 
getRequestPropertiesO; 

// process request 
processRequestO; 
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Fig. 4B(ii) 

// HttpAdapterBaselmpl 

// 

abstract class HttpAdapterBaselmpl implements HttpAdapter { 

HttpServletRequest req; 
HttpServIetResponse res; 

HttpAdapterBaseImpl(HttpServietRequest req, HttpServIetResponse res) { 

// construct new instance of the adapter and initialize it with the request 
// and response 

} 

createRequestObjectO { 

// build a RequestObject based on the request information 

} 

processRequestO { 

// convert from HttpServletRequest into / RequestObject 
RequestObject reqobj = createRequestObjectO; 

// pass request object and response object to web controller 
Http WebController.processRequest(reqobj , res); 

} 

getRequestO { 

return req; 

} 

TypedProperty getRequestPropertiesQ { 

// extract request properties from request and put in in a TypedProperty 

} 

} 

// 

// HttpBrowserAdapter 

// 

public class HttpBrowserAdapter extends HttpAdapterBaselmpl [ 

SessionContext getSessionContext() { 

// return an Http Browser sepcific session context 



// 

// HttpPVCAdapter 

// 

public class HttpPVCAdapter extends HttpAdapterBaselmpl implement HttpAdapter ) 



SessionContext getSessionContext() { 
// return a PVC sepcific session context 



CA920000049US1 
V. Chan, et al 
Method & System for a Computer System 
to Support Various Communication Devices 
9 of 21 



Fig. 4C(i) 



// 

// RequestObject - defines the request object that is passed to the web controller 
// from any network device 

// each adapter can have add adapter specific extension to this 

// for example. The Http Adapter adds the HttpServletRequest to this interface 

// 

interface RequestObject { 

// return the adapter used to format the incoming request 
getDeviceFormatAdapterO; 
// returns the input properties for the command 
getRequestPropertiesO; 
// returns the session context 
getSessionContextO; 

// sets the adapter used to process this request 
setDeviceFormatAdapterO; 
// set the input properties 
setRequestPropertiesO; 
// sets the session context 
setSessionContextO; 
// gets the command name 
get CommandNameO; 



404 



// 

// CommandContext - defines the information that can be accessible to the 
// command and the web controller to process a command 

// 

interface CommandContext() { 

// returns the device type 
getDeviceTypeO; 

// returns the input properties for the command 

getRequestPropertiesO; 

// returns the store Id 

getStoreldO; 

// returns the user id 

getUserldO; 

// returns the command name 

getCommandName(). 

setUserldO. 

// return the adapter used to fonnat the incoming request 
getAdapterO, 



406 
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Fig. 4C(ii) 



// processRequest 

// This is the main processing unit of the web controller 

// It is responsible for the execution of a command within a transaction 

// 

processRequest(RequestObject req, ResponseOject res) { 

// create a command context object based on the input request 
CommandContext commandContext = createCommandContext(req,res); 
try { 

// 

beginTransactionO; 

// set session data in command context 

retrieveSessionData(commandContext); 

// look up and instantiate command to be executed 
ECCommand command - prepareRequest(commandContext); 

// set input properties for command 
command,setRequestProperties(commandContext. 
getRequestPropertiesO) ; 

// set commandContext for command 
command,setCommandContext(); 

// execute command 
command. execute() ; 

// update session data based on info from command context 
updateSessionData(commandContext); 

// retrieve response properties from command 
responseProperties = command.getResponsePropertiesQ; 

// get a response view command 

viewCommand = prepareRespone(responseProperties, commandContext). 

// execute the view command 

if (viewCommand != null) { 

ViewCommand execute! ). 

commitTransactionO 
j catch (Exception e) { 

// 

rollbackTransactionO; 

// 

handleError(e,commandContext); 
} 

} 

» 
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Fig. 4C(iii) 

// 

// WebController is the abstract base class the handles any implementation that is 
// common for all web controllers 

// 



abstract class WebController { 

CommandContext createCommandContext(RequestObj req, ResponseObject res) { 
// save request object and response object in command context 
// also extract request parameters, request name, adapter type 

f 

ViewEntry getViewEntry(String commandName, CommandContext commandContext) { 
// look up view based on view name, storeld and device type 

} 

UrlEntry getUrlEntry{String commandName, CommandContext commandContext) { 
// look up url entry based on command name and storeld 

} 

ECCommand instantiateCommand( ViewEntry viewEntry, CommandContext 4 1 0 

commandContext) { 

// instantiate command based on interface for view command, store id 

i 

ECCommand instantiateCommand(UrlEntry urlEntry, CommandContext 4 1 0 

commandContext) { 
// instantiate command based on command interface, store id 
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Fig. 4C(iv) 

// HttpWebControIler handles any implementation that is specific to the Http protocol 
// 

public static class HttpWebControIler { 

ECCommand prepareRequest(CommandContext) throws Exception { 
// look up url entry from URLREG based on name and store id 

UrlEntry urlEntry =getUrlEntry(commandContext.getCommandName(),commandContext); 

if (urlEntry null) { 

// look up view based on view name, storeld and device type 
ViewEntry viewEntry = 

getViewEntry(commandContext.getCommandName(),commandContext); 
command = instantiateCommand(viewEntry,commandContext); 

} else { 

// check for https redirection 

if (urlEntry.isHttpsO && (!commandContext.isHttps()) { 

ViewEntry viewEntry = getViewEntry("HttpsRedirectView", commandContext); 

// instantiate command based on interface for view command, store id 
command = instantiateCommand(viewEntry,commandContext); 

} else { 

// instantiate command based on command interface, store id 
command = mstantiateCommand(urlEntry,commandContext): 

} 

} 

return command; 



// prepareResponse 

// 

ECCommand prepareResponse(TypedProperty responseProperties, CommandContext 
commandContext)throws Exception { 
// return view command; 

retneveSessionData(CommandContext commandContext) { 

// retrieve session data from session context and set it in command context 



updateSessionData(CommandContext commandContext) { 

// retrieve session data from command context and set it in session context 

\ 
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Fig. 4C(v) 

// 

// TypedProperty - an extended Hashtable that is used passed request and 

// response information to and from a command 

// 

class TypedProperty extends Hashtable { 



String getString(String parameterName) { 

// return the values of a parameter as a String 

} 

String getInteger(String parameterName) { 

// returns the value of a parameter as an Integer 

} 

StringO getStringArray(String parameterName) { 

// return the values of a parameter as an array of String 

putParameter(String parameterName, Object parameterValue) { 
// store the parameterValue against a parameterName 

} 
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Fig. 6A 

// 

//The MQ Adapter listens for incoming messages from the network 
// 

public class MQSerialAdapter { 

// 

serviceLoopO { 

while (true) { 

// get a message from the queue 
MQMessage msg = getRequestFromQueue(); 

// create an adapter to transform and process this message 
XmlAdapter adapter = createAdapter(MQMessage msg); 
adapter.processRequestO; 

} 

} 

} 

public class XmlAdapter implements DeviceFormatAdapter { 

processRequestO { 

// convert from message from xmi format mto a 

// RequestObject 

RequestObject reqobj = createRequestObject(job); 
// 

XMLWebControUer.processRequest(reqobj, job); 
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Fig. 6B 



// 

// XMLWebController handles any implementation that is specific to the MQAdapter 

public class XMLWebCobtroller extends WebController { 

ECCommand prepareRequest(CommandContext commandContext) throws Exception { 

// look up url entry from URLREG based on command name and storeld 
UrlEntry urlEntry = getUrlEntry(getCommandName{),commandContext); 

// instantiate command based on command mterface, store id 
command = instantiateCommand(urlEntry, commandContext); 

// 

return command; 

} 

ECCommand prepareResponse() throws Exception { 
II MQ don't need any response view 
return null; 

} 

retrieveSessionData(CommandContext commandContext) { 
// noop - MQ don't have session info 

) 

updateSessionData(CommandContext commandContext) \ 
II noop - MQ don't have session info 
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Fig. 7A 



// 

// Scheduler 

// The scheduler runs background jobs. They can be jobs that is to be executed only 

// once at a specified time or can be jobs that are to be run at regular intervals. 

// Jobs are added to the database with the request mformation, a preferred start time, user id 

// and or frequency intervals. 

// Job can be added from the browser or from another command 

// 

public class Scheduler { 

// 

serviceLoopO { 

while (true) { 

// sleep time is determined by the start time of next job 
sleepUntilNextJoblsToBeRunO; 

// retrieve the job that need to be executed now from the 

// database 

SchedulerJob job = getReadyToRunJob(): 

// allocate a thread to nin the job 

SchedulerThread thread = getThreadToRunJob(job); 

// start the thread 
thread.startO; 
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Fig.TB 

// 

// SchedulerThread 

// 

public class SchedulerThread { 
SchedulerJob job; 
run(){ 

service(job); 

} 

service(SchedulerJob job) { 

// create a scheduler adapter to process the job 
ScheduIerAdapter adapter = createSchedulerAdapter(3ob); 
adapter.processRequestO ; 

} 



II 

II ScheduIerAdapter 

// The scheduler adapter is responsible for converting a scheduler job into a request object 
// and pass on to the SchedulerWebController 

// 

public class Scheduler Adapter implements DeviceFormatAdapter^ 
processRequest () { 

// convert from scheduler job mfo into a RequestObject 
RequestObject reqobj = createRequestObjectOob); 



// pass request to SchedulerWebController to process 
SchedulerWebCobtroller.processRequest(reqobj, job); 
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Fig. 70 

// 

// ScheduIerWebControIIer handles any implementation that is specific to the scheduler 

// 

public static class SchedulerWebCobtrolier extends WebController { 

ECCommand prepareRequest(CommandContext commandContext) throws Exception { 

// look up url entry from URLREG based on command name and storeld 
UrlEntry urlEntry = 

getUrlEntry(getCommandName(),commandContext); 

// instantiate command based on command interface, store id 
command = instantiateCommand(urlEntry,commandContext); 

// 

updateDatabaseC'jobStarted"); 
return command; 

ECCommand prepareResponse{) throws Exception { 

// update scheduler database 
updateDatabaseC'jobCompleted"); 
// a background job do not return a view 
return null, 

retrieveSessionData(CommandContext commandContext) { 
// noop - scheduler don't have session info 

f 

updateSessionData(CommandContext commandContext) { 
// noop - scheduler don't have session info 
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